Update a placement

PATCH

placements

Update a placement

curl --request PATCH \
  --url https://your_a2_service/placements \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "campaign_permission": {
    "black": [],
    "white": []
  },
  "created_at": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "display": {
    "clktype": 1,
    "displayfmt": {
      "ext": {},
      "h": 250,
      "w": 300
    },
    "h": 250,
    "mime": [],
    "nativefmt": {
      "ext": {}
    },
    "w": 300
  },
  "ext": {
    "approval_method": "admin",
    "display": {
      "enabled": 0
    },
    "native": {
      "enabled": 0
    },
    "payout": "rates",
    "responsive": "fixed",
    "target_ecpm": 0,
    "video": {
      "enabled": 0
    }
  },
  "is_active": false,
  "partial_safe_update_only": false,
  "updated_at": "2023-11-07T05:31:56Z",
  "video": {
    "clktype": 1,
    "ctype": [
      2
    ],
    "delay": 0,
    "h": 300,
    "linear": 0,
    "maxdur": 0,
    "mime": [],
    "mindur": 0,
    "playmethod": [],
    "ptype": 1,
    "skip": 0,
    "skipafter": 0,
    "skipmin": 0,
    "w": 480
  }
}
'

{
  "created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "no": 123,
  "campaign_permission": {
    "black": [],
    "white": []
  },
  "created_at": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "display": {
    "clktype": 1,
    "displayfmt": {
      "ext": {},
      "h": 250,
      "w": 300
    },
    "h": 250,
    "mime": [],
    "nativefmt": {
      "ext": {}
    },
    "w": 300
  },
  "ext": {
    "approval_method": "admin",
    "display": {
      "enabled": 0
    },
    "native": {
      "enabled": 0
    },
    "payout": "rates",
    "responsive": "fixed",
    "target_ecpm": 0,
    "video": {
      "enabled": 0
    }
  },
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "is_active": false,
  "updated_at": "2023-11-07T05:31:56Z",
  "video": {
    "clktype": 1,
    "ctype": [
      2
    ],
    "delay": 0,
    "h": 300,
    "linear": 0,
    "maxdur": 0,
    "mime": [],
    "mindur": 0,
    "playmethod": [],
    "ptype": 1,
    "skip": 0,
    "skipafter": 0,
    "skipmin": 0,
    "w": 480
  }
}

Authorizations

Authorization

string

header

required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json

지면 수정 스키마

created_by

string<uuid>

required

지면을 생성한 사용자의 ID

string<uuid>

required

지면 고유 식별자

name

string

required

지면 이름

campaign_permission

Permission · object

deprecated

권한

표시 하위 속성

campaign_permission.black

string[]

campaign_permission.white

string[]

created_at

string<date-time> | null

생성 일시

description

string | null

The description in JSON Quill Delta format - a JSON format that represents rich text content

Links: https://quilljs.com/docs/delta

display

Display · object

디스플레이 배치 스키마. 배너 디스플레이 형식, 네이티브 형식 및 기타 디스플레이 관련 속성을 포함합니다.

표시 하위 속성

display.clktype

enum<integer>

default:1

사용 가능한 옵션:

0,

1,

2,

3

display.displayfmt

DisplayFormat · object

배너 디스플레이 형식의 속성(예: 크기)을 관리하는 객체 배열.

표시 하위 속성

display.displayfmt.ext

Ext · object

display.displayfmt.h

integer

default:250

display.displayfmt.w

integer

default:300

display.h

integer

default:250

display.mime

string[]

display.nativefmt

NativeFormat · object

네이티브 배치 스키마. 네이티브 배치 형식 및 기타 네이티브 관련 속성을 포함합니다.

표시 하위 속성

display.nativefmt.ext

Ext · object

display.w

integer

default:300

ext

PlacementExt · object

지면의 기본 추가 설정을 위한 스키마.

표시 하위 속성

ext.approval_method

enum<string>

default:admin

지면 게재 요청 시 승인 방법.

delegate: 지면 게재 권한이 있는 광고주는 지면 관리자의 승인 없이 게재가 가능합니다.
admin: 지면 관리자의 승인이 필요합니다.

사용 가능한 옵션:

admin,

delegate

ext.display

Display · object

ext.native

Native · object

ext.payout

enum<string>

default:rates

기본 과금은 알고리즘에 의해 결정되는 최적화된 CPC, CPM 또는 CPA 금액입니다.

none: 지면에 대한 과금이 계산되지 않음 rates: 알고리즘에 의해 결정되는 최적화된 CPC, CPM 또는 CPA 금액

사용 가능한 옵션:

none,

rates

ext.responsive

enum<string>

default:fixed

광고 소재가 지면 영역에 표시되는 방식을 정의

fixed: 광고 소재를 수정 없이 원본 크기로 표시 resized: 광고 소재 크기를 지면 영역 크기에 맞게 조정

사용 가능한 옵션:

fixed,

resized

ext.target_ecpm

number

default:0

ext.video

Video · object

is_active

boolean

default:false

partial_safe_update_only

boolean | null

default:false

지면이 사용 중일 때도 수정 가능한 필드 목록:

이름
설명
목표 eCPM

updated_at

string<date-time> | null

변경 일시

video

Video · object

Video

표시 하위 속성

video.clktype

enum<integer>

default:1

사용 가능한 옵션:

0,

1,

2,

3

video.ctype

integer[]

video.delay

integer

default:0

video.h

integer

default:300

video.linear

enum<integer>

default:0

사용 가능한 옵션:

0,

1,

2

video.maxdur

integer

default:0

video.mime

string[]

video.mindur

integer

default:0

video.playmethod

enum<integer>[]

사용 가능한 옵션:

1,

2,

3,

4,

5,

6,

7

video.ptype

enum<integer>

default:1

사용 가능한 옵션:

1,

2,

3,

4

video.skip

enum<integer>

default:0

사용 가능한 옵션:

0,

1

video.skipafter

integer

default:0

video.skipmin

integer

default:0

video.w

integer

default:480

Response

Successful Response

지면 엔티티를 위한 스키마.

created_by

string<uuid>

required

지면 생성 사용자 ID

name

string

required

이름

integer

required

campaign_permission

Permission · object

deprecated

권한

표시 하위 속성

campaign_permission.black

string[]

campaign_permission.white

string[]

created_at

string<date-time> | null

생성 일시

description

string | null

The description in JSON Quill Delta format - a JSON format that represents rich text content

Links: https://quilljs.com/docs/delta

display

Display · object

디스플레이 배치 스키마. 배너 디스플레이 형식, 네이티브 형식 및 기타 디스플레이 관련 속성을 포함합니다.

표시 하위 속성

display.clktype

enum<integer>

default:1

사용 가능한 옵션:

0,

1,

2,

3

display.displayfmt

DisplayFormat · object

배너 디스플레이 형식의 속성(예: 크기)을 관리하는 객체 배열.

표시 하위 속성

display.displayfmt.ext

Ext · object

display.displayfmt.h

integer

default:250

display.displayfmt.w

integer

default:300

display.h

integer

default:250

display.mime

string[]

display.nativefmt

NativeFormat · object

네이티브 배치 스키마. 네이티브 배치 형식 및 기타 네이티브 관련 속성을 포함합니다.

표시 하위 속성

display.nativefmt.ext

Ext · object

display.w

integer

default:300

ext

PlacementExt · object

지면의 기본 추가 설정을 위한 스키마.

표시 하위 속성

ext.approval_method

enum<string>

default:admin

지면 게재 요청 시 승인 방법.

delegate: 지면 게재 권한이 있는 광고주는 지면 관리자의 승인 없이 게재가 가능합니다.
admin: 지면 관리자의 승인이 필요합니다.

사용 가능한 옵션:

admin,

delegate

ext.display

Display · object

ext.native

Native · object

ext.payout

enum<string>

default:rates

기본 과금은 알고리즘에 의해 결정되는 최적화된 CPC, CPM 또는 CPA 금액입니다.

none: 지면에 대한 과금이 계산되지 않음 rates: 알고리즘에 의해 결정되는 최적화된 CPC, CPM 또는 CPA 금액

사용 가능한 옵션:

none,

rates

ext.responsive

enum<string>

default:fixed

광고 소재가 지면 영역에 표시되는 방식을 정의

fixed: 광고 소재를 수정 없이 원본 크기로 표시 resized: 광고 소재 크기를 지면 영역 크기에 맞게 조정

사용 가능한 옵션:

fixed,

resized

ext.target_ecpm

number

default:0

ext.video

Video · object

string<uuid> | null

is_active

boolean

default:false

updated_at

string<date-time> | null

변경 일시

video

Video · object

Video

표시 하위 속성

video.clktype

enum<integer>

default:1

사용 가능한 옵션:

0,

1,

2,

3

video.ctype

integer[]

video.delay

integer

default:0

video.h

integer

default:300

video.linear

enum<integer>

default:0

사용 가능한 옵션:

0,

1,

2

video.maxdur

integer

default:0

video.mime

string[]

video.mindur

integer

default:0

video.playmethod

enum<integer>[]

사용 가능한 옵션:

1,

2,

3,

4,

5,

6,

7

video.ptype

enum<integer>

default:1

사용 가능한 옵션:

1,

2,

3,

4

video.skip

enum<integer>

default:0

사용 가능한 옵션:

0,

1

video.skipafter

integer

default:0

video.skipmin

integer

default:0

video.w

integer

default:480

Get a placement지면을 조회합니다.

⌘I

Update a placement

curl --request PATCH \
  --url https://your_a2_service/placements \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "campaign_permission": {
    "black": [],
    "white": []
  },
  "created_at": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "display": {
    "clktype": 1,
    "displayfmt": {
      "ext": {},
      "h": 250,
      "w": 300
    },
    "h": 250,
    "mime": [],
    "nativefmt": {
      "ext": {}
    },
    "w": 300
  },
  "ext": {
    "approval_method": "admin",
    "display": {
      "enabled": 0
    },
    "native": {
      "enabled": 0
    },
    "payout": "rates",
    "responsive": "fixed",
    "target_ecpm": 0,
    "video": {
      "enabled": 0
    }
  },
  "is_active": false,
  "partial_safe_update_only": false,
  "updated_at": "2023-11-07T05:31:56Z",
  "video": {
    "clktype": 1,
    "ctype": [
      2
    ],
    "delay": 0,
    "h": 300,
    "linear": 0,
    "maxdur": 0,
    "mime": [],
    "mindur": 0,
    "playmethod": [],
    "ptype": 1,
    "skip": 0,
    "skipafter": 0,
    "skipmin": 0,
    "w": 480
  }
}
'

{
  "created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "no": 123,
  "campaign_permission": {
    "black": [],
    "white": []
  },
  "created_at": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "display": {
    "clktype": 1,
    "displayfmt": {
      "ext": {},
      "h": 250,
      "w": 300
    },
    "h": 250,
    "mime": [],
    "nativefmt": {
      "ext": {}
    },
    "w": 300
  },
  "ext": {
    "approval_method": "admin",
    "display": {
      "enabled": 0
    },
    "native": {
      "enabled": 0
    },
    "payout": "rates",
    "responsive": "fixed",
    "target_ecpm": 0,
    "video": {
      "enabled": 0
    }
  },
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "is_active": false,
  "updated_at": "2023-11-07T05:31:56Z",
  "video": {
    "clktype": 1,
    "ctype": [
      2
    ],
    "delay": 0,
    "h": 300,
    "linear": 0,
    "maxdur": 0,
    "mime": [],
    "mindur": 0,
    "playmethod": [],
    "ptype": 1,
    "skip": 0,
    "skipafter": 0,
    "skipmin": 0,
    "w": 480
  }
}

Data Management APIs

Decision APIs

Authorizations

Body

Response